/**
 * @apiDefine inventory 盘点
 * @apiHeader {String} token 用户登录获取的token
 */

/**
 * @api {POST} /inventory_list 盘点列表
 * @apiSampleRequest /inventory_list
 * @apiGroup inventory
 * @apiUse inventory
 * @apiParam {Number} [type] 盘点方式 1 按月份盘点 2 抽盘
 * @apiParam {Number} [page=1] 分页
 * @apiParam {Number} [size=15] 每页数据条数
 * @apiSuccess {Object} /data 数据
 * @apiSuccessExample {json} 成功响应：
 * HTTP/1.1 200 OK
 * {
 *     "errcode": 0,
 *     "data": [
 *         {
 *             "id": 1,
 *             "i_sn": "2112211632130001", // 盘点单号
 *             "name": "聊天",
 *             "add_time": "2021-12-21T16:32:13",
 *             "shop_id": 70, // 盘点店铺
 *             "add_user": 7, // 盘点人
 *             "type": 1, // 盘点方式 1 按月份盘点 2 抽盘
 *             "status": 1, // 盘点状态 0未提交，1已提交待审核，2审核中，3审核通过，4审核未通过，5已作废
 *             "check_user": null, // 审核人
 *             "check_time": null, // 审核时间
 *             "should_num": 0, // 应盘商品
 *             "actual_num": 0, // 实盘商品
 *             "surplus_num": 0, // 盘盈商品
 *             "deficit_num": 0, // 盘亏商品
 *             "leak_num": 0, // 漏盘商品
 *             "no_diff_num": 0, // 无差异商品
 *             "remark": null, // 备注
 *             "step": 0 // 盘点进度
 *         }
 *     ],
 *     "page": 1,
 *     "size": 15,
 *     "total": 1
 * }
 */

/**
 * @api {POST} /inventory 盘点详情
 * @apiSampleRequest /inventory
 * @apiGroup inventory
 * @apiUse inventory
 * @apiParam {Number} [id] 盘点ID
 * @apiSuccess {Object} /data 数据
 * @apiSuccessExample {json} 成功响应：
 * HTTP/1.1 200 OK
 * {
 *     "errcode": 0,
 *     "data": {
 *         "id": 12, // 盘点ID
 *         "i_sn": "2112240009", // 盘点单号
 *         "name": "ok", // 盘点名称
 *         "add_time": "2021-12-24T15:39:54", // 盘点时间
 *         "shop_id": 70, // 盘点店铺
 *         "add_user": 7, // 盘点人
 *         "type": 1, // 盘点方式 1 按月份盘点 2 抽盘
 *         "status": 0, // 盘点状态 0 未提交，1已提交待审核，2 已审核(已完成)，3 已作废
 *         "check_user": null, // 审核人
 *         "check_time": null, // 审核时间
 *         "should_num": 2271, // 应盘商品
 *         "actual_num": 0, // 实盘商品
 *         "surplus_num": 0, // 盘盈商品
 *         "deficit_num": 0, // 盘亏商品
 *         "leak_num": 0, // 漏盘商品
 *         "no_diff_num": 0, // 无差异商品
 *         "remark": null, // 备注
 *         "step": 1 // 盘点进度 1盘点商品，2核对盈亏表，3完成盘点
 *     }
 * }
 */

/**
 * @api {POST} /create_inventory 创建盘点
 * @apiSampleRequest /create_inventory
 * @apiGroup inventory
 * @apiUse inventory
 * @apiParam {String} name 盘点名称
 * @apiParam {String} type 盘点方式 1 按月份盘点 2 抽盘
 * @apiSuccess {Object} /data 数据
 * @apiSuccessExample {json} 成功响应：
 * HTTP/1.1 200 OK
 * {
 *     "errcode": 0,
 *     "data": {
 *         "id": 1,
 *         "i_sn": "2112211632130001",
 *         "name": "聊天",
 *         "add_time": "2021-12-21 16:32:13",
 *         "shop_id": 70,
 *         "add_user": 7,
 *         "type": 1,
 *         "status": 0
 *     }
 * }
 */

/**
 * @api {POST} /inventory_goods_list 盘点商品列表
 * @apiSampleRequest /inventory_goods_list
 * @apiDescription <ol>
 *     </li>如果商品没有被盘点，盘点相关字段的值都为null，可以使用商品表内的数据做为盘点默认值</li>
 *     </ol>
 * @apiGroup inventory
 * @apiUse inventory
 * @apiParam {Number} id 盘点ID
 * @apiParam {Number} class_id 商品分类ID
 * @apiParam {Number} [flag] 0未盘（漏盘），1已盘，2无差异，3盘盈，4盘亏
 * @apiParam {Number} [status] 审核状态 0未审核,2审核中,3审核通过,4审核未通过
 * @apiParam {Number} [page=0] 分页，如果page>0，获取分页数据，否则获取全部数据
 * @apiParam {Number} [size] 每页数据条数
 * @apiSuccess {Object} /data 数据
 * @apiSuccessExample {json} 成功响应：
 * HTTP/1.1 200 OK
 * {
 *     "errcode": 0,
 *     "data": [
 *         {
 *             "id": null,
 *             "i_id": null, // table_inventory表id
 *             "good_price": null, // 商品售价
 *             "good_cost": null, // 商品进货价
 *             "should_count": null, // 账面库存
 *             "should_money": null, // 账面金额
 *             "actual_count": null, // 实盘库存
 *             "actual_money": null, // 实盘金额
 *             "pal_count": null, // 盈亏数量
 *             "pal_money": null, // 盈亏金额
 *             "state": null, // 盈亏状态：0 正常 1 盘盈 2 盘亏
 *             "reason": null, // 审核未通过原因
 *             "check_time": null, // 审核时间
 *             "goods_id": 2757,
 *             "class_id": 5,
 *             "goods_name": "苹果",
 *             "scount": "965.000", // 库存
 *             "usdt_price": 198.0, // 单价
 *             "shoper_id": 70
 *             "product_date": "2021-11-18",
 *             "guarantee_period": 0,
 *             "guarantee_type": 1,
 *             "goods_img": ""
 *         },
 *     ],
 *     "total": 6,
 *     "page": 1,
 *     "size": 15
 * }
 */

/**
 * @api {POST} /save_inventory_detail 盘点商品
 * @apiSampleRequest /save_inventory_detail
 * @apiGroup inventory
 * @apiUse inventory
 * @apiParam {Number} inventory_id 盘点ID
 * @apiParam {Number} goods_id 商品ID
 * @apiParam {Number} [actual_count] 实盘库存，flag=1时，参数无效
 * @apiParam {Number} [flag=0] 1删除盘点商品
 * @apiSuccess {Object} /data 数据
 * @apiSuccessExample {json} 成功响应：
 * HTTP/1.1 200 OK
 * {
 *     "errcode": 0
 * }
 */

/**
 * @api {POST} /cancel_inventory 作废
 * @apiSampleRequest /cancel_inventory
 * @apiGroup inventory
 * @apiUse inventory
 * @apiParam {Number} ids 盘点ID，多个“,”连接
 * @apiSuccess {Object} /data 数据
 * @apiSuccessExample {json} 成功响应：
 * HTTP/1.1 200 OK
 * {
 *     "errcode": 0
 * }
 */

/**
 * @api {POST} /submit_inventory 提交
 * @apiSampleRequest /submit_inventory
 * @apiDescription <p>当step设置为3时，后台将status设置为1（待审核状态）</p>
 * @apiGroup inventory
 * @apiUse inventory
 * @apiParam {Number} id 盘点ID
 * @apiParam {Number} step 阶段 1盘点商品，2核对盈亏表，3完成盘点
 * @apiSuccess {Object} /data 数据
 * @apiSuccessExample {json} 成功响应：
 * HTTP/1.1 200 OK
 * {
 *     "errcode": 0
 * }
 */

/**
 * @api {POST} /inventory_progress 按商品分类统计已盘数量
 * @apiSampleRequest /inventory_progress
 * @apiGroup inventory
 * @apiUse inventory
 * @apiParam {Number} id 盘点ID
 * @apiParam {Number} [flag] 0未盘（漏盘），2无差异，3盘盈，4盘亏
 * @apiSuccess {Object} /data 数据
 * @apiSuccessExample {json} 成功响应：
 * HTTP/1.1 200 OK
 * {
 *     "errcode": 0,
 *     "data": [
 *         {
 *             "id": 3, // 商品盘点ID
 *             "class_id": 4, // 商品分类ID
 *             "num": 1, // 已盘
 *             "class_name": "手拎包" // 商品分类
 *         },
 *     ]
 * }
 */


/**
 * @api {POST} /update_inventory_stats_data 更新盘点统计
 * @apiSampleRequest /update_inventory_stats_data
 * @apiGroup inventory
 * @apiUse inventory
 * @apiParam {Number} id 盘点ID
 * @apiSuccess {Object} /data 数据
 * @apiSuccessExample {json} 成功响应：
 * HTTP/1.1 200 OK
 * {
 *     "errcode": 0
 * }
 */


/**
 * @api {POST} /stats_inventory_goods 统计已盘点商品
 * @apiSampleRequest /stats_inventory_goods
 * @apiGroup inventory
 * @apiUse inventory
 * @apiParam {Number} id 盘点ID
 * @apiSuccess {Object} /data 数据
 * @apiSuccessExample {json} 成功响应：
 * HTTP/1.1 200 OK
 * {
 *     "errcode": 0,
 *     "data": {
 *         "ctg_num": 1, // 已盘点商品种数
 *         "total_num": "2.000", // 已盘点商品总数
 *         "total_amount": "5.00" // 已盘点总金额
 *     }
 * }
 */
